home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / graphics / dmorf_1.zip / PLAY.DOC < prev    next >
Text File  |  1992-07-15  |  10KB  |  274 lines
  1.  
  2.  
  3. Trilobyte SVGA FLICK & Groovie Player.
  4. Copyright 1991 Trilobyte, all rights reserved.
  5.  
  6.  
  7. This is version 0.80 of Trilobyte's SVGA FLICK player.
  8.  
  9. Version 0.80 adds:
  10.     zillions of bug fixes too numerous to mention here
  11.     no more Hercules Graphic Station support (1 user registered)
  12.  
  13. Version 0.74 adds:
  14.     Fixed mouse region bug
  15.     Fixed mouse clutter bug
  16.     Fixed subroutine line reading bug
  17.     Added _icon for more icon types
  18.     
  19. Version 0.73 adds:
  20.     Script labels in form [label] for script files
  21.     Jump parameter for scripts in format _jump label
  22.     Loop parameter for mouse and keyboard input form: _startsub....._endsub
  23.     Keyboard input in form     _keyin "k" label (must be inside loop)
  24.     Mouse regions in form _region xlo ylo xhi yhi label (must be insider loop)
  25.     Added return parameter for breaking out of script form: _return num (num=errlevel)
  26.     Fixed 1280x1024 animation bug
  27.  
  28. Version 0.72 adds:
  29.     Fixed VESA 320x200 blanking in scripts bug
  30.     Fixed hang bug with getinmem routine
  31.  
  32. Version 0.71 adds:
  33.     Added    _cd n to script for controlling mscdex cd rom audio (n=track, 99=stop)
  34.     Fixed script comment bug
  35.  
  36. Version 0.7 adds:
  37.     Added -mn command line for VESA mode
  38.         n = 0 320x200x256
  39.         n = 1 640x400x256
  40.         n = 2 640x480x256
  41.         n = 3 800x600x256
  42.         n = 4 1024x768x256
  43.         n = 5 1280x1024x256
  44.     Added auto-res for animations in VESA mode
  45.     Added -fn command line for fading in/out (n = 1 fade in, 
  46.         n = 2 fade out, n = 3 fade in and out)
  47.     Added mouse click to end animation
  48.     Fixed non-VESA command line bug
  49.     Made maximum animation size 53megs
  50.     Added ascii script format
  51.  
  52. Version 0.6 adds:
  53.     Starts animations off at the correct speed
  54.     Added -s command line option for speed (e.g. play myflie.fli -s9)
  55.     Added -l command line option for looping (e.g play myfile.fli -l9)
  56.     Added -g command line option for staying in graphic mode once done
  57.     Added ability to play back Groovie 0.1 files
  58.     Added Grey Scale toggle with Home key
  59.  
  60. Version 0.5 adds:
  61.     Detects processor type and uses processor specific instructions
  62.     Fixed bug on uncompressed .FLI files
  63.     Added luminence control with Pgup/Pgdown keys (not on Hercules)
  64.     Added Home key for returning back to original palette
  65.     Fixed bug with palette fades
  66.     Fixed VESA win.granulality bug
  67.     Added support for RAM/EMS/FILE caching
  68.     Made .FLI limit 16 megabytes
  69.  
  70. Version 0.4 fixes:
  71.     Problems with storing seek position on some .fli files
  72.     Problems with 320x200 first frame
  73.     Hercules Graphics Station version uses 386 instructions
  74.     Variable speed playback with 1-9 keys
  75.     Escape from the program with the ESC key
  76.  
  77. Version 0.3 adds support for:
  78.     Hercules Graphic Station Card
  79.     Fixed bugs
  80.     Made old 320x200x256 animations play in 320x200 mode
  81.     Center other animations into middle of screen
  82.  
  83. Version 0.2 adds support for:
  84.     Tseng 4000
  85.     Oak Technologies
  86.     VESA
  87.  
  88. How to use the Player
  89.  
  90. Using the program is simple.  All you have to do is type "PLAY filename.FLC"
  91. or "PLAY scriptname.SSS", the program will try and detect the SVGA card you 
  92. have, and then start to play the animation in 640x480x256 resolution. 
  93. Programs that generate .FLC's at this resolution include Autodesk 3D Studio 
  94. and Autodesk Animator Pro.
  95.  
  96. For best results when using the player, play the animation with lots of
  97. expanded memory free.  Play uses expanded memory to store the animation.  To
  98. use expanded memory you must first install a driver like EMM.SYS.
  99.  
  100. To stop the player from animating, press the Esc key, the player will change 
  101. back to text mode and return you to dos.
  102.  
  103. To vary the playback speed, press the keys 1-9 on the keyboard, pressing 0
  104. will restore the speed saved in the animation.
  105.  
  106. To change the luminence of the animation use the Pgup/Pgdown keys, Home
  107. returns the colors back to normal.
  108.  
  109. To toggle grey scale on/off press the Home key.  Useful for that old movie
  110. effect.
  111.  
  112. To change the number of loops, use the -ln or /ln option on the command line.
  113. For example:
  114.     Play myfli.flc -l10
  115. will play "myfli.fli" ten times.  The maximum number of loops is 65535.  A
  116. value of 0 will loop forever.
  117.  
  118. To change the speed from the command line, use the -sn or /sn option.
  119. For example:
  120.     Play myfli.flc -s10
  121. will play "myfli.fli" at speed ten.  Speeds can be between 0 and 255.
  122.  
  123. To stop Play changing the video mode back to text once finished, use the /g
  124. or -g option on the command line.
  125. For example:
  126.     Play myfli.flc -l10 -s10 -g
  127. will play "myfli.fli" ten times at speed ten and then stay in graphics mode
  128. when it exits.
  129.     
  130. DISCLAIMER - AGREEMENT
  131.  
  132. Users of PLAY must accept this disclaimer of warranty:
  133. "PLAY is supplied as is.  The author disclaims all
  134. warranties, expressed or implied, including, without limitation,
  135. the warranties of merchantability and of fitness for any purpose.
  136. The author assumes no liability for damages, direct or conse-
  137. quential, which may result from the use of PLAY."
  138.  
  139. PLAY V.80 is a "shareware program" and is provided at no charge
  140. to the user for evaluation.  Feel free to share it with your
  141. friends, but please do not give it away altered or as part of
  142. another system.  The essence of "user-supported" software is to
  143. provide personal computer users with quality software without
  144. high prices, and yet to provide incentive for programmers to
  145. continue to develop new products.  If you find this program
  146. useful and find that you are using PLAY and continue to use
  147. PLAY after a reasonable trial period, you must make a reg-
  148. istration payment of $39.00 to Trilobyte.  The $39.00
  149. registration fee will license one copy for use on any one
  150. computer at any one time.  You must treat this software just like
  151. a book.  An example is that this software may be used by any
  152. number of people and may be freely moved from one computer
  153. location to another, so long as there is no possibility of it
  154. being used at one location while it's being used at another.
  155. Just as a book cannot be read by two different persons at the
  156. same time.
  157.  
  158. Commercial users of PLAY must register and pay for their
  159. copies of PLAY within 30 days of first use or their license
  160. is withdrawn.  Site-License arrangements may be made by contacting
  161. Trilobyte at the address below.
  162.  
  163. Anyone distributing PLAY for any kind of remuneration must
  164. first contact Trilobyte at the address below for authorization.
  165.  
  166. You are encouraged to pass a copy of PLAY V.80 along to your
  167. friends for evaluation.  Please encourage them to register their
  168. copy if they find that they can use it.  All registered users
  169. will receive a copy of the latest version of the PLAY
  170. system, the scripting program "Groovie", software support via mail, and
  171. free upgrades/fixes for 90 days from date of registration.
  172.  
  173. DEFINITION OF SHAREWARE
  174.  
  175. Shareware distribution gives users a chance to try software
  176. before buying it. If you try a Shareware program and continue
  177. using it, you are expected to register. Individual programs
  178. differ on details -- some request registration while others
  179. require it, some specify a maximum trial period.
  180.  
  181. Copyright laws apply to both Shareware and commercial software,
  182. and the copyright holder retains all rights, with a few specific
  183. exceptions as stated below. Shareware authors are accomplished
  184. programmers, just like commercial authors, and the programs are
  185. of comparable quality. (In both cases, there are good programs
  186. and bad ones!) The main difference is in the method of
  187. distribution. The author specifically grants the right to copy
  188. and distribute the software, either to all and sundry or to a
  189. specific group. For example, some authors require written
  190. permission before a commercial disk vendor may copy their
  191. Shareware.
  192.  
  193. Shareware is a distribution method, not a type of software. You
  194. should find software that suits your needs and pocketbook,
  195. whether it's commercial or Shareware. The Shareware system makes
  196. fitting your needs easier, because you can try before you buy.
  197. And because the overhead is low, prices are low also. Shareware
  198. has the ultimate money-back guarantee -- if you don't use the
  199. product, you don't pay for it.
  200.  
  201. If you would like to register, please send a check, made payable to Trilobyte,
  202. for $39 to:
  203.  
  204.     Trilobyte
  205.     PO Box 1412
  206.     Jacksonville
  207.     Oregon, 97530
  208.  
  209.     (503) 899 1113
  210.  
  211. YOU HAVE TO REGISTER TO GET THE SCRIPT MAKER "GROOVIE" !!!
  212.  
  213. * U.S. funds only.  Non-U.S. customers please use International Postal Order
  214.  
  215. If you have any comments, please send them to:
  216.     Compuserve: 72330,3276
  217.         Genie     : R.LANDEROS
  218.     Internet  : 72330,3276@compuserve.com
  219.  
  220. Thank you for using the Trilobyte SVGA FLICK & Groovie Player
  221.  
  222. ;
  223. ;
  224. ; pointer file format
  225. ;
  226. ;
  227.  
  228. The palette for the pointer is stored in pointer.col, it is an autodesk
  229. animator pro palette file.  This palette is remapped into new palettes when
  230. the mouse pointer is displayed.
  231.  
  232. The pointer is a 32x32 pixel sprite.  The file format for the pointer is
  233. a straight binary 1024 byte file, one byte for every pixel.  A value of
  234. 0 indicates a transparent pixel.
  235.  
  236. The stream is left to right, top to bottom.
  237.  
  238. Animator Pro does not output such pointer files, it's possible to write a 
  239. poco to do this though without too much hassle.
  240.  
  241.  
  242. Play script format
  243. (c) 1991 Trilobyte
  244.  
  245. The first line of a script must be SCRIPT
  246.  
  247. Commands:
  248.  
  249.  
  250. ; - Comment field
  251.  
  252. anim.flc -m0 -l3 - command line animation
  253.  
  254. _cd n - play track n on a audio cd-rom drive
  255.  
  256. [label] - put this label here
  257.  
  258. _jump label - jump to this label
  259.  
  260. _startsub - start an input routine
  261.  
  262. _keyin "k" label - look for key "k" (the k key), if pressed jump to label
  263.            MUST BE IN A STARTSUB - ENDSUB LOOP
  264. _region xlo ylo xhi yhi label - if the mouse is in region xlo ylo xhi yhi
  265.                 jump to label
  266.                 MUST BE IN A STARTSUB - ENDSUB LOOP
  267.  
  268. _endsub - end an input routine
  269.  
  270. _return n - end and return this value
  271.  
  272. _icon name - load a different icon for displaying
  273. 
  274.